home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / ss_28.zip / SS!SYSOP.DOC < prev    next >
Text File  |  1992-12-11  |  15KB  |  324 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                      S u p e r S l o t s !                     /
  4.     /                           Version 2.8                          /
  5.     /                                                                /
  6.     /                       (c) Copyright 1992                       /
  7.     /                       All Rights Reserved                      /
  8.     /                         J & W Software                         /
  9.     /                                                                /
  10.     /                                                                /
  11.     /     Slot Machine game -DOOR- for  Wildcat!,  PCBoard 14.x,     /
  12.     /     RA/QBBS,  SPITFIRE,  GAP and other  BBS software which     /
  13.     /     uses door information files compatible with the above.     /
  14.     /                                                                /
  15.     /                                                                /
  16.     /                           Support BBS:                         /
  17.     /                          Gulf Coast BBS                        /
  18.     /                          (904) 563-2547                        /
  19.     /                         1200 - 14400 HST                       /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     SuperSlots! is a fun (and addictive) game DOOR for Bulletin  Board 
  27.     Systems.   It is a close approximation of a real slot  machine  at 
  28.     your  favorite casino.  There is even a Super Progressive  Jackpot 
  29.     which  starts out at $100,000,000 and increases by  $10,000  after 
  30.     each game.  Playing the game is simple.  Place your bet, pull  the 
  31.     handle  and let the wheels spin.  The strategy is knowing when  to 
  32.     bet big and when to bet small.  Players compete for weekly/monthly
  33.     and all time high scores.
  34.  
  35.  
  36.     FEATURES
  37.     --------
  38.  
  39.     - ANSI Color and Mono screens with sound and animation
  40.     - Straight ASCII mode for users without ANSI/IBM displays
  41.     - Full multi-node support
  42.     - Support for locked DTE up to 115K bps
  43.     - Support for COM1 through COM8 and IRQs 1 through 15
  44.     - FOSSIL support
  45.     - DESQview aware
  46.     - Easy installation and no maintenance
  47.  
  48.  
  49.     SETUP
  50.     -----
  51.  
  52.     Setup  is  very simple.  Create a directory and  place  the  files 
  53.     SUPRSLOT.EXE and SS!SETUP.EXE in this directory.
  54.  
  55.     Change to this directory and run SS!SETUP.  A screen with  several 
  56.     fields  will be displayed.  There will be a box at the  bottom  of 
  57.     the  screen  that will display help information  for  each  field. 
  58.     The following  edit  keys are allowed:  HOME, END, BACKSPACE, LEFT
  59.     and RIGHT ARROW.  Use the  ENTER,  UP and  DOWN ARROW keys to move
  60.     between the different fields.
  61.  
  62.     Each field is described below:
  63.  
  64.     Name: The name of the person registering the program as it will be
  65.     displayed on  the opening screen (when registered).  This does not
  66.     necessarily have  to  be the SysOp, it could be the name of a user
  67.     who donated the registration fee.
  68.  
  69.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  70.     opening screen (when registered).
  71.  
  72.     Key Number:  If registered, enter your Key Number here.  Until the
  73.     program  is registered leave this field  as  all zeroes.   See the
  74.     registration section below for more information about registering.
  75.  
  76.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  77.     bulletin file. If left blank no file will be written.
  78.  
  79.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  80.     Color) bulletin file.  If left blank no file will be written.
  81.  
  82.     Use  Internal  or  FOSSIL  com   routines  [I/F]:    The  type  of
  83.     communications support  that should be used.  SuperSlots!  can use
  84.     either its own  Internal  communication  routines  or an installed
  85.     FOSSIL  driver.  For  systems  not  using a FOSSIL driver,  choose
  86.     Internal  routines.  The Internal  communication routines  support
  87.     COM1 through COM8 with IRQs  of 1 through 15.  For systems using a
  88.     FOSSIL  driver,  you  may choose  either the  Internal  or  FOSSIL
  89.     routines.
  90.  
  91.     Base Address  (COM1 through COM8):  If you are  using the Internal
  92.     communication routines on ports  other than  COM1 or COM2 you must
  93.     enter the Base Address of the ports, in hex, for the ports you are
  94.     using.  Note that  the Base Address  for COM1 and  COM2  cannot be
  95.     changed.
  96.  
  97.     IRQ  (COM1 through COM8):   If  you   are   using   the   Internal
  98.     communication  routines on ports other  than COM1 or COM2 you must
  99.     enter the IRQ of the  ports you are using.  Note that the IRQs for
  100.     COM1 and COM2 cannot be changed.
  101.  
  102.     After entering all of the information, press 'ESC'.  SS!SETUP will 
  103.     ask if you  want to save the  configuration file.  If this  is the
  104.     first time  SS!SETUP  has  been run  or you  have  previously  run
  105.     SS!SETUP  but  changed some of the information, press  'Y'.   This 
  106.     will  create or update the configuration file (SUPRSLOT.CFG).   It 
  107.     will also create a SUPRSLOT.SCO file if one does not exist.   This
  108.     is the score file and is needed for the program to run.
  109.  
  110.     It  will  then  ask if you want to create  the  registration  file 
  111.     (SUPRSLOT.REG).   The  registration file will be needed  when  the 
  112.     program is registered, so you will need to answer 'Y' at least one
  113.     time for this file to be created.  Please be sure all  information 
  114.     is correct as your 'Key Number' will be based on this information.
  115.  
  116.     Consult your BBS manual regarding the creation of DOOR batch files
  117.     for your BBS.  SUPRSLOT.EXE must be started from the  directory it
  118.     resides in for the game to function.  The command line for calling
  119.     SuperSlots! is as follows:
  120.  
  121.     SUPRSLOT SUPRSLOT.CFG 'Full pathname to BBS information file'
  122.  
  123.     'Full pathname to BBS information file'
  124.  
  125.     This  will be the full path and filename of your  BBS  information 
  126.     file.  For  example: C:\PCB\PCBOARD.SYS.   SuperSlots!  uses  this 
  127.     filename  to  determine the BBS software which is  being  used  as 
  128.     follows:
  129.  
  130.     CALLINFO.BBS (Wildcat 2.xx)
  131.     PCBOARD.SYS  (PCBoard)
  132.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  133.     SFDOORS.DAT  (SPITFIRE)
  134.     DORINFOx.DEF (RA/QBBS/RBBS)
  135.  
  136.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not
  137.     fully compatible  with RBBS.  By default, SuperSlots! uses the RA/
  138.     QBBS  DORINFOx.DEF format.  If you  are using  the RBBS version of
  139.     DORINFOx.DEF,  use the parameter  "/RBBS"  (without quotes) on the
  140.     command line in your calling batch file.
  141.  
  142.     An example of a batch file for PCBoard:
  143.  
  144.     CD\SUPRSLOT
  145.     SUPRSLOT SUPRSLOT.CFG C:\PCB\PCBOARD.SYS
  146.     CD\PCB
  147.     BOARD.BAT
  148.  
  149.     An example of a batch file for RBBS using DORINFOx.DEF:
  150.  
  151.     CD\SUPRSLOT
  152.     SUPRSLOT SUPRSLOT.CFG C:\RBBS\DORINFO1.DEF /RBBS
  153.     CD\RBBS
  154.     BOARD.BAT
  155.  
  156.  
  157.     UPGRADING
  158.     ---------
  159.  
  160.     To upgrade  from versions 2.5+,  replace the old  SUPRSLOT.EXE and
  161.     SS!SETUP.EXE files  with  the  new  version 2.8  SUPRSLOT.EXE  and
  162.     SS!SETUP.EXE files and run SS!SETUP.
  163.  
  164.     If you  are  using  the  RBBS  version  of  DORINFOx.DEF,  add the
  165.     parameter  "/RBBS"  (without quotes)  to the  command  line in the
  166.     calling batch file.
  167.  
  168.     To upgrade from version 2.3 to version 2.8 follow these steps:
  169.  
  170.     1 - Replace the existing SUPRSLOT.EXE with the new SUPRSLOT.EXE
  171.     2 - Delete your existing SUPRSLOT.CFG
  172.     3 - Run SS!SETUP to create the new SUPRSLOT.CFG
  173.     4 - Modify your batch file(s) for the new command line syntax
  174.  
  175.     Multiple  configuration files are no longer necessary  if  running 
  176.     multi-node.
  177.  
  178.     If  upgrading  from a version earlier than 2.3 you  will  need  to 
  179.     delete  your score file and install SuperSlots! over again.   This 
  180.     is  necessary  since the score files from earlier versions are not
  181.     compatible with version 2.8.
  182.  
  183.  
  184.     ERRORS
  185.     ------
  186.  
  187.     Any  errors  which may occur will be written to  the  SUPRSLOT.ERR 
  188.     file.  When possible, a descriptive error message will be  written 
  189.     to  SUPRSLOT.ERR with the exact cause of the error.  If the  error 
  190.     cannot  be resolved,  call the  support BBS  (Gulf Coast BBS)  and
  191.     upload a copy of your SUPRSLOT.CFG,  SUPRSLOT.SCO and SUPRSLOT.ERR
  192.     files.  This will allow us to more quickly  determine the cause of
  193.     the error. All support is handled through the Gulf Coast BBS.
  194.  
  195.  
  196.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  197.     ------------------------------------
  198.  
  199.     SuperSlots! has been  developed in a  networked  environment.  All
  200.     multi-node features have been thoroughly tested on multi-node sys-
  201.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  202.     full record and file locking is supported.  Multiple configuration
  203.     files are NOT necessary when running on multi-node systems.
  204.         
  205.     SuperSlots!  is  DESQview  aware.  It is  automatically  detected,
  206.     screen and  keyboard I/O are  "well behaved",  and time slices are
  207.     released to other applications where appropriate.  SuperSlots! has
  208.     been  tested with  3 nodes running  simultaneously  under DESQview
  209.     (all ports  locked at  38400)  with no  noticeable effect on other
  210.     nodes.
  211.  
  212.  
  213.     MISCELLANEOUS
  214.     -------------
  215.  
  216.     There is  an optional command line  parameter  (/MONTHLY) to reset
  217.     the score file  at  the beginning  of each  month instead  of each
  218.     week.  Place this at  the very end of the line  in your batch file
  219.     calling SuperSlots!.  For example:
  220.  
  221.     SUPRSLOT SUPRSLOT.CFG C:\PCB\PCBOARD.SYS /MONTHLY
  222.  
  223.     This switch was added because of the requests from a few customers
  224.     for tournament use. It's use is not recommended.  Players who lose
  225.     their entire  bankroll will quickly  lose interest in  the game if
  226.     they must wait until a new month starts to play again.
  227.  
  228.     SuperSlots!  is designed to give each player a $500,000  stake  to
  229.     begin the game.  At the beginning of the  selected time period the
  230.     score file will automatically be cleared and the last periods high
  231.     scorer will be determined.
  232.  
  233.     Each player is given a Sysop configurable number of turns to start
  234.     with and  will gain an extra turn  each time they win. If a player
  235.     does not complete all their turns, they may call back and play any
  236.     remaining turns later that day.
  237.  
  238.     If  the  Super Jackpot is won, it will be reset  to  $100,000,000.  
  239.     The  winning  players  name,  date and amount  they  won  will  be 
  240.     displayed on the menu screen.
  241.  
  242.     If you are using a high speed modem and have your com port LOCKED, 
  243.     the  program will not respond to keyboard input while  your  modem 
  244.     buffer is full.  This is normal.
  245.  
  246.     SuperSlots! may be played from the DOS prompt by typing: 
  247.  
  248.     SUPRSLOT SUPRSLOT.CFG LOCAL
  249.  
  250.     Note that the user name is hard coded as 'SysOp' and the bulletins 
  251.     will not be updated  (the score file will).  This mode is only for
  252.     testing. The file LOCAL.BAT is included for this purpose.
  253.  
  254.     To turn on screen writing, if it is off, press any key.
  255.  
  256.  
  257.     REGISTRATION
  258.     ------------
  259.  
  260.     Registration is required if you choose to continue using this DOOR 
  261.     program.   After 60 days of running the program unregistered,  the 
  262.     score  file  will  cease to be updated.  However,  the  game  will 
  263.     continue  to allow players to play. This should be long enough  to 
  264.     determine if the program meets your needs and is popular with your 
  265.     users.
  266.  
  267.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  268.     with a 'Registered To:' message.  This will show the Name and  BBS 
  269.     Name from the SUPRSLOT.CFG file.
  270.  
  271.     There are two ways to register.
  272.  
  273.                         * Mail order Registration *
  274.  
  275.     If the SUPRSLOT.REG form  was not previously created, run SS!SETUP
  276.     and have it  create SUPRSLOT.REG.  Check this  file to  insure the
  277.     information is correct. If it is not, re-run  SS!SETUP and correct
  278.     any errors.   Your Key Number is based on the information in  this
  279.     file  and must be correct for your  Key Number to work.  Make sure
  280.     that the Name and BBS Name are correct as printed! When done print
  281.     the form  to your printer.  Send the  completed  SUPRSLOT.REG form
  282.     along with  your check, money order,  VISA, MasterCard or Discover
  283.     Discover credit card information for $15.00 (US) to:
  284.  
  285.                               J & W Software
  286.                           9426 N. China Pink Way
  287.                       Crystal River, FL  34428-9500
  288.  
  289.     Your personalized Key Number will be sent to you promptly. When it
  290.     is received, run SS!SETUP  and enter your Key Number.  SuperSlots!
  291.     will then be registered. No other action is necessary.
  292.  
  293.  
  294.                      * Instant On-Line Registration *
  295.  
  296.     You may register SuperSlots! with VISA, MasterCard or Discover and
  297.     receive your personalized Key Number instantly by calling the Gulf
  298.     Coast BBS, (904) 563-2547,  and entering REGISTER at the main menu
  299.     prompt.  You  will need the  Name  and  BBS Name  exactly as it is
  300.     entered on  lines 1 & 2  of  SS!SETUP as well as  your credit card
  301.     information to  register.  You  might  want  to make  note of this
  302.     information to speed  your call.  You will receive your Key Number
  303.     on that call.
  304.  
  305.  
  306.     WARRANTY & DISCLAIMER
  307.     ---------------------
  308.  
  309.     There  are  no warranties, express or  implied,  for  unregistered 
  310.     copies of SuperSlots!.  The author will NOT be held liable for any 
  311.     direct,  indirect, incidental, or consequential  damage  resulting 
  312.     from  the  use  of  this  program.   Your  use  of  this   program 
  313.     constitutes your AGREEMENT to this disclaimer and your release  of 
  314.     the author from any form of liability.
  315.  
  316.     Registered  copies  of  SuperSlots! are warranted  to  perform  as 
  317.     described  in this documentation.  In the event  SuperSlots!  does 
  318.     not  perform  as described, then the author will elect  to  either 
  319.     rectify the problem or refund the amount of the registration paid,
  320.     provided notification is received within 30 days of registration.
  321.  
  322.  
  323.                                  - END -
  324.